home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 1 / The 640 Meg Shareware Studio CD-ROM Volume I (Data Express)(1992).ISO / os2 / ps2asst.txt < prev    next >
Text File  |  1992-05-09  |  18KB  |  348 lines
  1.  
  2.  
  3.                          IBM PS/2 ASSISTANT (TM)
  4.                       Developed by Mark T. Chapman
  5.               IBM NDD National Support Center, Atlanta, GA.
  6.                     Copyright (C) IBM Corp. 1989-1992
  7.                                ───  ─── 
  8.  
  9. The intent of this file is to explain what the IBM PS/2 Assistant is, how to
  10. install it, how to obtain future upgrades, and what problems or limitations you
  11. might run into while installing or using it.
  12.  
  13. A complete list of the files that you should have is as follows:
  14.                           PS2ASST.TXT  (This File)
  15.                           PS2A_GEN.INF
  16.                           PS2A_MKT.INF
  17.                           PS2A_SVC.INF
  18.                           PS2A_TEC.INF
  19.                           PS2A_TSP.INF
  20.                           PS2A_TTL.INF
  21. The purpose of these files is described below.
  22.  
  23.  
  24. OVERVIEW
  25. ────────
  26. The IBM PS/2 Assistant is an online help tool composed of PS/2 and OS/2-related
  27. marketing, service, technical and general information.  It comprises five parts:
  28. the IBM PS/2 Marketing Assistant (PS2A_MKT.INF), the IBM PS/2 Service Assistant
  29. (PS2A_SVC.INF), the IBM PS/2 Technical Assistant (PS2A_TEC.INF), the IBM PS/2
  30. Technical Specifications Assistant (PS2A_TSP.INF), and the IBM PS/2 General
  31. Information Assistant (PS2A_GEN.INF).  These files may be viewed separately, or
  32. together, according to the user's preference.  For convenience, the files will
  33. be collectively called the "PS/2 Assistant" throughout the rest of this
  34. document.
  35.  
  36. The PS/2 Assistant is a binary file created by compiling a scripted ASCII text
  37. file, using the Information Presentation Facility (IPF) Tag Language and
  38. Compiler.  They are included in the OS/2 V1.2 and 1.3 Programming Tools and
  39. Information toolkits (P/Ns 6024929 or 85F1671).  The PS/2 Assistant requires
  40. OS/2 1.2 (or later) to operate, because it uses the OS/2 VIEW.EXE command to
  41. access the file.  This is the same command used to display the online OS/2
  42. Command Reference.  Since both files were created with the same compiler, and
  43. are displayed by the same command, they look and act very much alike.  So if
  44. you know how to use one, you also know how to use the other.
  45.  
  46. Features include:
  47.  - A Table of Contents listing a number of sections containing PS/2, OS/2,
  48.    DOS, and AIX Marketing information; PS/2 and OS/2 Service information;
  49.    and PS/2 and OS/2 Technical information, as well as a PS/2 Assistant
  50.    overview and usage instructions tutorial (About PS/2 Assistant).
  51.  - A keyword Search capability, which highlights all occurrences of a word or
  52.    phrase, anywhere in the PS/2 Assistant, and displays all sections containing
  53.    that string in a selection window.
  54.  - A Print feature allowing you to print the Table of Contents, any section
  55.    or group of marked sections, or the entire document (over 600 pages worth!).
  56.  - A Copy-to-clipboard function for copy/paste use.
  57.  - A Copy/Append-to-ASCII-File capability to save to disk for future use.
  58.  - A Bookmark feature to save a list of the frequently-referred-to sections
  59.    for quicker access.
  60.  - Contextual online Help for general usage information.
  61.  
  62.  
  63. The PS/2 Assistant was tested, and does work, across an OS/2 LAN Server V1.2
  64. network.  Still, keyword searches may take longer across a network than
  65. directly on a local workstation.  Menu access doesn't appear to be affected by
  66. the network.  Because the PS/2 Assistant is only about 1MB in size, you may
  67. wish to load it on the individual workstations (rather than on the server).
  68. (For instructions on Setting Up an OS/2 LAN Server to Share On-line Books, see 
  69. the document by the same name in the Networking Tips section of the Tips-and-
  70. Techniques heading in the PS/2 Technical Assistant.)
  71.  
  72. INSTALLING AND STARTING THE PS/2 ASSISTANT
  73. ──────────────────────────────────────────
  74. For performance reasons I strongly recommend that you copy the files to a hard
  75. drive.  You may wish to add the PS/2 Assistant to the C:\OS2\BOOK directory,
  76. which already contains the online OS/2 Command Reference (and OS/2 LAN Command
  77. Reference, if you have the LAN Requester installed).  If you prefer to  
  78. create a separate directory for the Assistant, you should also change the     
  79. SET BOOKSHELF= statement in CONFIG.SYS.  For example, if you create a directory
  80. called PS2ASST, change SET BOOKSHELF=  from:
  81.  
  82. SET BOOKSHELF=C:\OS2\BOOK 
  83.  
  84.           to       
  85.  
  86. SET BOOKSHELF=C:\OS2\BOOK;C:\PS2ASST
  87. This tells OS/2 where to look for online books.)                                                                       
  88.  
  89. | Then for OS/2 1.x either:
  90.  
  91. 1) Create a menu option (using Program...New from the Group action bar)
  92. containing the following information:
  93.  
  94.      Program Title:  PS/2 Marketing Assistant
  95.      Path:           C:\OS2\VIEW.EXE
  96.      Parameters:     PS2A_MKT                                
  97.  
  98. and simply click on the PS/2 Assistant menu option to run the program.
  99.  
  100.                                    or,
  101.  
  102. 2) Type:
  103.  
  104.      VIEW PS2A_MKT                                           
  105.  
  106. to run the program directly from the command prompt.
  107.  
  108. | For OS/2 2.0:  
  109. | 1) Open the Information object on the desktop, and use Create Another (or hold
  110. |    down the Ctrl key and drag a book icon elsewhere in the folder and then drop
  111. |    it) to duplicate an existing book object
  112. | 2) Open the icon Settings and change the Parameter field to the name of one PS/2
  113. |    Assistant book; then change the icon title
  114. | 3) Repeat steps 1) and 2) for the other books
  115. |
  116. | Or, use the VIEW command as in OS/2 1.x.
  117.  
  118. To install the PS/2 Service Assistant and the PS/2 Technical Assistant, simply
  119. repeat the process, substituting the other titles and file names in the above
  120. example.
  121.  
  122. | If you would like to automatically start the PS/2 Marketing Assistant when you
  123. | boot up your system, add the following statement to your OS/2 1.x STARTUP.CMD 
  124. | batch file:
  125.  
  126.  
  127.  
  128.  
  129.     START C:\OS2\VIEW.EXE PS2A_MKT.INF
  130.  
  131. | Or, OS/2 2.0 users can add the book icon to the Startup folder.
  132.  
  133. If you would like to logically link the five books together (to simplify
  134. keyword searches of all the information in the three files) into one big menu,
  135. you can type from a command line (or put in a batch file or CONFIG.SYS):
  136.  
  137.     SET PS2ASST=PS2A_MKT.INF+PS2A_SVC.INF+PS2A_TEC.INF+PS2A_TSP.INF+PS2A_GEN.INF
  138. This will create one "virtual" book called PS2ASST (or any other name you     
  139. choose to assign).  To see the data, just VIEW PS2ASST as you would with one  
  140. of the component files, or use PS2ASST as the parameter in a group setup.     
  141.  
  142. OR, create a menu option containing the following information (the file names
  143. can be in whatever order you prefer):
  144.  
  145.     Program Title:  PS/2 Assistant
  146.     Path:           C:\OS2\VIEW.EXE
  147.     Parameter:      PS2A_MKT+PS2A_SVC+PS2A_TEC+PS2A_TSP+PS2A_GEN
  148.  
  149. (The disadvantage to these approaches is that the "About PS/2 Assistant" menu
  150. heading will appear four times each on the combined menu, because it exists in
  151. all four files.  This makes the menu a bit more cluttered, but nothing more.)
  152. In the above examples, the title of the combined book would be "IBM PS/2 
  153. Marketing Assistant" because that is the title of the first file in the SET 
  154. command.  If another file were first, its title would be used instead.  
  155.  
  156. There is one additional (517 byte) .INF file on the diskette, named 
  157. PS2A_TTL.INF, which is merely a title header.  If you precede the other file 
  158. names in the examples above with this file name, your title will read "IBM PS/2
  159. Assistant" as the title, instead of "IBM PS/2 Marketing Assistant."  This may
  160. be less confusing when you sometimes look at just one section of the PS/2
  161. Assistant, and other times link several sections together.           
  162.  
  163. (NOTE: In case you are wondering why the .INF extension was used in some of
  164. the examples above, but not others, the answer is that it is optional when
  165. using the VIEW command directly, as in VIEW xxxx; however when the START
  166. command is used to launch a program, or the SET command is used to link files
  167. together, the fully-qualified program and file names are required.  Not using
  168. the .INF extension in these cases will cause a "Cannot Open Input File"
  169. error.)
  170.  
  171. Finally, you may wish to create a new menu (Group) specifically for the PS/2
  172. Assistant, or for all online books, including the OS/2 and LAN command
  173. references.  To do this, simply go to the Desktop Manager and select Group. 
  174. Then select New, and type in a Group Name (say PS/2 Assistant, or Online
  175. Books).  After deciding whether to have the menu auto-start when you boot up
  176. (under 1.3 or later), and whether to start minimized or "normalized", click on
  177. Add, and you are done.  Once the group has been added, you can set up the menu
  178. to include the Assistant books, by using Program...New, and filling in the
  179. fields, as described above.
  180.  
  181. *** TIP ***
  182. If you already have the Assistant installed on a menu, and want to move the
  183. entries to their own group, you can simply drag and drop (using the "alternate"
  184. (right button for right-handed users) mouse button) from one Group window to
  185. another.  This will save a lot of typing (in the new Group) and deleting (from
  186. the old Group).  This "trick" works with any Group menu items.
  187.  
  188.  
  189.  
  190.  
  191. USAGE INSTRUCTIONS
  192. ──────────────────
  193. Information on using the PS/2 Assistant is available by double-clicking on the
  194. first menu option (Overview and Usage Instructions) of the Contents menu.  If
  195. you are familiar with using the OS/2 Online Command Reference, then you already
  196. know how to use the PS/2 Assistant; however there is some information specific
  197. to the PS/2 Assistant contained in this section that should be read before
  198. using the first time.
  199.  
  200. *** HOT TIP ***                                                               
  201. If you know the name of the section you will be looking in first, you can jump
  202. directly to that section from the command line.  For example, if you want to  
  203. look up a phone number, rather than typing VIEW PS2A_GEN, and then selecting  
  204. the IBM Phone Number list, and then the IBM Voice Phone Numbers, you could    
  205. type:                                                                         
  206.                         VIEW PS2A_GEN VOICE                                   
  207.  
  208. and jump directly to that section.  This technique works only for the FIRST   
  209. menu topic containing that keyword.  If, for example, you searched on PHONE,  
  210. you would get the IBM Phone Number header.                                    
  211.  
  212. This trick won't always get you where you want to go on the first try, but it 
  213. can be a time-saver once you get the hang of it.                              
  214.  
  215. ******************************************************************************
  216.  
  217. UPDATES
  218. ───────
  219. The PS/2 Assistant is updated twice-monthly, and released via the IBM NSC BBS
  220. (see below) for end-users (PS2ASST.EXE), or the MKTTOOLS disk (PS2ASST PACKAGE)
  221. for IBMers.  IBM Developer Assistance Program (IDAP) members, and customers
  222. registered as Technical Coordinators, who have access to IBMLINK also may
  223. download the PS/2 Assistant (PS2ASST PACKAGE) from the ESDTOOLS disk.  IBMers
  224. may type in the following command from the VM command line to get the latest
  225. copy of the PS/2 Assistant:
  226.  
  227.          TOOLCAT MKTTOOLS GET PS2ASST PACKAGE
  228.  
  229. If this doesn't work, use the following:
  230.  
  231.          TOOLS SENDTO BCRVMMS1 TOOLS MKTTOOLS GET PS2ASST PACKAGE
  232.  
  233. To subscribe to the PS/2 Assistant (and receive future updates automatically),
  234. type: 
  235.  
  236.          TOOLS SENDTO BCRVMMS1 TOOLS MKTTOOLS SUB PS2ASST PACKAGE
  237.  
  238. If you have any comments, suggestions, or find any errors, please let me know.
  239. I can be reached through the IBM NDD National Support Center BBS. (Dealers
  240. registered with the IBM Technical Advisor program may use the 800 # to call  
  241. the Technical Advisor BBS (TA BBS) set up for them.  Others may call         
  242. 404-835-6600 for the first available modem line; or 404-835-5300 for USR
  243. Dual-Standard 9600 baud modems; or 404-835-5578 for IBM 7855 modem lines; or
  244. 404-835-6296 for Hayes V-Series or Ultra Smartmodems.) Communication
  245. parameters supported are 300-9600 baud; N,8,1).  
  246.  
  247. IBMers can reach me internally at T/L 269-6432 or MCHAPMAN @ DAYVM2.  There is
  248. also a PS2ASST FORUM available on the IBMPC disk.
  249.  
  250. Prodigy users may leave a message for JPJS05A.
  251.  
  252. ******************************************************************************
  253.  
  254.  
  255.  
  256.  
  257. KNOWN PROBLEMS AND LIMITATIONS
  258. ──────────────────────────────
  259. 1) If you are using SE 1.2 ship-level (ie. without the November 1989 Update),
  260. the IBM PS/2 Assistant V1.40 or later will not work ("Cannot Open Input File"
  261. message).  This is due to my switching to the updated IPF compiler (which fixed
  262. some bugs in the original compiler) that requires the SE 1.2 update.  EE 1.2 
  263. users already have the update incorporated into the ship-level code. Only SE 
  264. 1.2 users with a SYSLEVEL of less than XR04020 are affected.  (This does not 
  265. affect EE 1.2 users, all of whom have a minimum SYSLEVEL of 4053 or later.)
  266.  
  267. 2) It appears that you cannot print from the Assistant if the OS/2 Spooler is
  268. disabled. If you receive printing errors, check to be sure the spooler is
  269. enabled, or type SPOOL at a command prompt to enable it.
  270.  
  271. 3) In some instances a multi-part search string (for example, MATH COPROCESSOR)
  272. may not return all valid matches.  This is a limitation of the VIEW.EXE command.
  273. If you do not get as many "hits" as you expect, try a shorter search string
  274. (such as COPROCESSOR), or use wildcards (MATH *PRO*).  Single-word searches   
  275. appear to work correctly.
  276.  
  277. 4) If you try to use STARTUP.CMD to start more than one .INF file (whether    
  278. PS/2 Assistant, CMDREF.INF, or other online help file) you may receive an OS/2 
  279. error message for each attempt after the first.  This is due to a  
  280. timing problem (the second copy trying to load before the first finishes) in
  281. OS/2 1.2 and 1.3.  The fix for this bug is in OS/2 V1.30.1 (also called CSD
  282. 5015).
  283.  
  284. 5) If you accidentally (or intentionally) delete the OS/2 1.2 Courier font from
  285. the system, IPF (under which the PS/2 Assistant runs) will incorrectly
  286. substitute a proportional font instead of the system monospace font.  This has
  287. the effect of messing up the alignment of text in all the monospaced documents
  288. (such as the price list and technical specs documents!).  This has been
  289. reported to OS/2 development and will be corrected in a future 1.2 CSD.
  290.  
  291. 6) There seems to be an intermittent problem using the PS/2 Assistant on an
  292. OS/2 LAN Server V1.2 network.  Occasionally, the first time the PS/2 Assistant
  293. is started a Protection Violation error will be encountered when the first menu
  294. option is selected.  If a Search is attempted before a menu option is selected,
  295. Search ignores the search request.  It doesn't appear to be a serious problem.
  296. It happens only sporadically, and only once.  If you start the Assistant again,
  297. immediately after the PV error, it will work correctly the second time, and
  298. every time after that until the next time you reboot.
  299.  
  300. 7) When using OS/2 V1.3, the fixed-pitch font (such as in the price list) used 
  301. by OS/2 is larger than that used in V1.2.  Therefore less text will fit on the 
  302. screen than before, both horizontally and vertically.  This is not a problem   
  303. vertically, since you can just scroll up and down to see all the information;  
  304. but some data may be cut off on the right side of the screen.  There is no way 
  305. to see this information currently.  I have no control over this limitation, and
  306. there are too many lines of fixed pitch text (10-15,000 lines) to change
  307. manually.  Until a new version, or Corrective Service Diskette, gives me (or 
  308. the user) the ability to select a font size, or scroll horizontally, this will 
  309. be a permanent limitation.  Workarounds include using an 8514/A adapter and
  310. compatible high-resolution display; or staying with OS/2 1.2 for the time being.
  311.  
  312.  
  313.  
  314.  
  315. 8) There may be a problem trying to print (from VIEW.EXE) INF file information
  316. on a PostScript printer.  If you encounter strange wrapping problems on a PS
  317. printer, try changing your printer into IBM Proprinter (or other ASCII printer)
  318. emulation mode if your printer has such a mode (or any other emulation mode
  319. that is known to work with the PS/2 Assistant).  Then set the Print Manager
  320. Application Default (from Setup) to use an OS/2 driver compatible with this
  321. printer mode.  (If this works, don't forget to reset your printer mode and OS/2
  322. driver back to their original settings when done printing from the Assistant.
  323. If your printer is capable of printing ASCII files, another approach is to use
  324. the Copy to File pulldown option.  This will save the selected sections to a
  325. file called TEXT.TMP, in the same directory as the INF file you are copying
  326. from.  Then simply use the File Manager to drag-and-drop the file to the Print
  327. Manager icon.  Then answer the prompt for the device driver to use, and when
  328. prompted whether the data is Graphics or Text, specify Text.  (The reason for 
  329. doing it this way, rather than using the Print command, is that many PS 
  330. printers do not automatically switch from PS mode to ASCII mode, and tend to 
  331. "eat" the ASCII file instead of printing it.  The drag/drop method forces the
  332. printer into ASCII mode, if the printer has an ASCII mode.)
  333.  
  334. 9) If you are using the Assistant on a network, make sure that all INF files
  335. are set up with read-only attributes, otherwise all users trying to share a
  336. file that is already open will receive "access denied" error messages.  This
  337. is true of any INF files you might be sharing (command reference, etc.).
  338.  
  339. I hope you find this tool to be useful.  Good luck!
  340.  
  341.                                Mark Chapman
  342.                 Advisory Marketing Support Representative
  343.                 IBM NDD National Support Center, Atlanta.
  344.  
  345. NOTE: The IBM PS/2 Assistant is copyrighted by IBM, and may not be modified in
  346. any manner, or for any reason.  See the "About PS/2 Assistant" menu option in 
  347. the PS/2 Assistant for Trademark information and additional disclaimers.
  348.